/*******************************************************************************
 * Copyright (c) 2008, 2025 SWTChart project.
 *
 * This program and the accompanying materials are made
 * available under the terms of the Eclipse Public License 2.0
 * which is available at https://www.eclipse.org/legal/epl-2.0/
 *
 * SPDX-License-Identifier: EPL-2.0
 * 
 * Contributors:
 * yoshitaka - initial API and implementation
 *******************************************************************************/
package org.eclipse.swtchart;

import org.eclipse.swt.custom.StyleRange;
import org.eclipse.swt.graphics.Color;
import org.eclipse.swt.graphics.Font;

/**
 * A title.
 */
public interface ITitle {

	/**
	 * Sets the title text.
	 * 
	 * @param title
	 *            the title text
	 */
	public void setText(String title);

	/**
	 * Gets the title text.
	 * 
	 * @return the title text
	 */
	public String getText();

	/**
	 * Sets the font for title text.
	 * 
	 * @param font
	 *            the font for title text
	 */
	public void setFont(Font font);

	/**
	 * Gets the font for title text.
	 * 
	 * @return the font size for title text
	 */
	public Font getFont();

	/**
	 * Sets the foreground color of title.
	 * 
	 * @param color
	 *            the foreground color of title
	 */
	public void setForeground(Color color);

	/**
	 * Gets the foreground color of title.
	 * 
	 * @return the foreground color of title
	 */
	public Color getForeground();

	/**
	 * Sets the style ranges. When style ranges are set, the font and background
	 * color set by {@link #setFont(Font)} and {@link #setForeground(Color)}
	 * makes no effect. Instead, the font and background color in style ranges
	 * are used.
	 * 
	 * @param styleRanges
	 *            the style ranges, or <code>null</code> to clear the currently set
	 *            style ranges.
	 */
	public void setStyleRanges(StyleRange[] styleRanges);

	/**
	 * Gets the style ranges.
	 * 
	 * @return the style ranges
	 */
	public StyleRange[] getStyleRanges();

	/**
	 * Sets the visibility state of title.
	 * 
	 * @param visible
	 *            the visibility state
	 */
	void setVisible(boolean visible);

	/**
	 * Gets the visibility state.
	 * 
	 * @return true if title is visible
	 */
	boolean isVisible();
}